package com.example.demo.mapper;

import com.example.demo.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

/**
 * 用户数据访问层接口
 * 负责用户相关的数据库操作
 */
@Mapper
public interface UserMapper {
    
    /**
     * 根据用户名查询用户信息
     * @param username 用户名
     * @return 用户信息，不存在返回null
     */
    User selectByUsername(@Param("username") String username);
    
    /**
     * 根据邮箱查询用户信息
     * @param email 邮箱地址
     * @return 用户信息，不存在返回null
     */
    User selectByEmail(@Param("email") String email);
    
    /**
     * 根据手机号查询用户信息
     * @param phone 手机号码
     * @return 用户信息，不存在返回null
     */
    User selectByPhone(@Param("phone") String phone);
    
    /**
     * 根据邮箱查询用户信息（排除指定用户ID）
     * @param email 邮箱地址
     * @param excludeUserId 排除的用户ID
     * @return 用户信息，不存在返回null
     */
    User selectByEmailExcludeUser(@Param("email") String email, @Param("excludeUserId") Long excludeUserId);
    
    /**
     * 根据手机号查询用户信息（排除指定用户ID）
     * @param phone 手机号码
     * @param excludeUserId 排除的用户ID
     * @return 用户信息，不存在返回null
     */
    User selectByPhoneExcludeUser(@Param("phone") String phone, @Param("excludeUserId") Long excludeUserId);
    
    /**
     * 根据ID查询用户信息
     * @param id 用户ID
     * @return 用户信息，不存在返回null
     */
    User selectById(@Param("id") Long id);
    
    /**
     * 插入新用户
     * @param user 用户信息
     * @return 影响的行数
     */
    int insert(User user);
    
    /**
     * 根据ID更新用户信息
     * @param user 用户信息
     * @return 影响的行数
     */
    int updateById(User user);
    
    /**
     * 根据ID删除用户
     * @param id 用户ID
     * @return 影响的行数
     */
    int deleteById(@Param("id") Long id);
}
